home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1998 April / EnigmA AMIGA RUN 26 (1998)(G.R. Edizioni)(IT)[!][issue 1998-04].iso / earkit / useful / picturedt-v43 / readme < prev   
Text File  |  1998-03-13  |  12KB  |  354 lines
  1.  
  2.                         picture.datatype V43
  3.                           Copyright 1995-97
  4.                            Ralph Schmidt
  5.            Additional libs/tools/changes by F.Mariak/M.Scheler
  6.            All sub datatypes by Matthias Scheler
  7.  
  8.  
  9. This  version is a freely available picture.datatype that MUST ONLY be used
  10. with  a  licenced  CyberGraphX(TM)  software  package  when using non 8 bit
  11. screenmodes. It also works with the recently released V3 version of
  12. CyberGraphX and you are allowed to use it with this also.
  13. You aren't allowed to use this software with any non licenced CyberGraphX(TM)
  14. "emulation"  in these modes.
  15. Usage of any of the included sub datatype classes with picture.datatype v43
  16. clones needs permission from their respective authors.
  17.  
  18. THE DATE EXPIRATION CODE HAS BEEN REMOVED. IT DOES NOT EXPIRE AFTER 4MONTH
  19. ANYMORE.
  20.  
  21. cyberncg.library support for non CyberGraphX machines has been dropped.
  22.  
  23. ******************************************************************************
  24.  
  25. Reporting bugs:
  26.  
  27. If   you   find   any   bugs   in   this  software,  please  send  them  to
  28. cybergfx.dtbugs@vgr.com.   Since  this  software is unsupported, we make no
  29. guarantees  about  how  long  it will take to fix the bug, or if it will be
  30. fixed  at  all.   Bug fixes will be cheerfully accepted.  Please include as
  31. much detailed information as possible, including:
  32.  
  33.     1) the version numbers of the related libraries/datatypes you are
  34.        using
  35.     2) the data file that caused the bug (if its not too big)
  36.     3) the OS version and machine type you ran the program on
  37.  
  38. ******************************************************************************
  39.  
  40. #########################
  41. #                       #
  42. #Important Informations #
  43. #                       #
  44. #########################
  45.  
  46. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  47. IF YOU'RE USING THE APPS THAT ARE IN THE COMPATIBILITY LIST( CHECK OUT SOME
  48. LINES  BELOW)  YOU  HAVE  TO NAME YOUR APPLICATION EXACTLY LIKE IN THE LIST
  49. OTHERWISE WON'T RECOGNIZE IT.
  50. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  51.  
  52. The  Aminet  release  of the png.datatype supports the V43 picture.datatype
  53. but  because  of  a  late change to the API(DTA_ErrorLevel,DTA_ErrorNumber)
  54. these  don't  support  these  tags.   I  hope  that  the authors of these 2
  55. datatype update their datatypes in the next time.
  56.  The  tags  are VERY important in a low memory situation.
  57.  
  58.  A  V43  compatible tiff.datatype as well as an bmp.datatype have also been
  59. released so far.
  60.  
  61.  
  62. Problems
  63.  
  64. o PPaint doesn't load 24bit images. Well..PPaint checks the BMHD.depth of
  65.   the raw data for >8...too bad
  66.  
  67. o Picview outputs "not a standard bitmap or something like that". This
  68.   is caused by the cgfx "PLANESTOFAST" option.
  69.  
  70. The following functions aren't implemented yet.
  71.  
  72. o 24bit dithering to a very small depth planar bitmap may cause
  73.   "problems". No time to test this out.
  74. o Sorry...also no time(lazyness) to test out PixMap support. I hope
  75.   it works as defined.
  76. o Right now it also doesn't really care for Ham6/8 and Halfbright.
  77. o DTM_Print for truecolour pictures should differ the picture to 256 colours
  78.   and then print it.
  79. o Make a Gauge interface so it may be controlled by tags(but does that
  80.   really make sense ? imagine a gauge popping up when iprefs is loading
  81.   your background)
  82. o scrollable transparent picture handling should be improved.
  83.   Now it only switches back in nonmask mode.
  84. o ******* AMosaic crashes ******* in 16Bit mode...i don't know why
  85.   yet(it worked in that mode in summer of 95 ......).
  86.  
  87.  
  88. ############################################################################
  89.  
  90.  
  91. The jfif.datatype is using the "jpeg.codec"
  92.  
  93. The JPEG codec is Copyright © 1994 Christoph Feck, TowerSystems.
  94. All Rights Reserved.  It is based in part on the work of the
  95. Independent JPEG Group.
  96.  
  97. ############################################################################
  98.  
  99.  
  100.  
  101.  
  102. ****************************************************************************
  103.  
  104. ATTENTION:
  105.  
  106. YOU  NEED TO HAVE AT LEAST VERSION 40.66 OF CYBERGRAPHICS.LIBRARY INSTALLED
  107. TO  USE THIS RELEASE OF PICTURE.DATATYPE V43 IN CONJUNCTION WITH A GRAPHICS
  108. CARD !
  109.  
  110. IF YOU INSTALL THIS ARCHIVE ON A DRACO BASED SYSTEM PLEASE MAKE SURE NOT TO
  111. INSTALL THE CYBERGRAPHICS.LIBRARY COMING WITH THIS ARCHIVE !
  112.  
  113. ****************************************************************************
  114.  
  115.  
  116. Release Notes 43.758a
  117. =====================
  118.  
  119. PICDT43.lha V43.758a
  120.  
  121.  o fixed a problem with the JFIF descriptor being for the wrong jfif.datatype
  122.  
  123. ----------------------------------------------------------------------------
  124.  
  125. PCDT Prefs 43.4
  126.  
  127.  o PCDT now always opens on the default Publicscreen and pops the screen to
  128.    front if required
  129.  
  130. PCDT Prefs 43.3
  131.  
  132.  o PCDT now also works now when the v43 picture.datatype is actually not
  133.    running
  134.  
  135. PCDT Prefs 43.2 
  136.  
  137.  o changed preferences format with pcdt > rev 752
  138.  
  139. ----------------------------------------------------------------------------
  140.  
  141. picture.datatype V43.758
  142.  
  143.  o minor internal changes
  144.  o added additional $VER version tag to picture.datatype file
  145.  o modified PictureClassExt.h as proposed by Rolanz Mainz on the DataType
  146.    mailing list.
  147.  o the gif.datatype has been removed by the author's request. Reading and/or
  148.    writing of GIF images requires a license to use Unisys patented Lempel Ziv
  149.    Welch (LZW) data compression and decompression technology, including US
  150.    Patent No. 4,558,302 & foreign counterpart patents. Therefore the
  151.    gif.datatype has been removed from the PictDT43 archive so that it may be
  152.    uploaded to Aminet (for the CDROM).It is available as a seperate archive.
  153.  
  154. V43.757
  155.  
  156.  o fixes some trouble with crashes on certain machines
  157.  
  158. V43.755
  159.  
  160.  o new pcdt prefs program v43.3 included
  161.  o new sub classes included
  162.  o added stack swapping code to picture.datatype dispatcher in order to fix
  163.    stack overflow related problems with applications which do not allocate
  164.    enough stack space
  165.  
  166. V43.754
  167.  
  168.  o fixed some bugs in method DTM_DRAW
  169.  o fixed some problems in conjunction with halfbrite source data
  170.  o new gif.datatype 43.14 included
  171.  
  172. V43.753
  173.  
  174.  o new pcdt prefs program v43.2 included
  175.  o the preferences file now has moved to env:sys
  176.  o new gif.datatype 43.13 included which fixes some strange crash problems
  177.  o fixed some problems in conjunction with planar graphic formats which
  178.    occasionally led to strange looking mwb-patterns
  179.  
  180. V43.751
  181.  
  182.  o the public semaphore is now available even if the picture.datatype is
  183.    expunged. This fixes a severe crash when the library is expunged
  184.  
  185. V43.750
  186.  o fixed a BYTE-READ from $0 when non v43 compatible applications called the 
  187.    picture.datatype
  188.  
  189. V43.748
  190.  
  191.  o gtlayout.library included in this archive. (required for the prefs
  192.    program)
  193.  o The application list which contains all V43 compatible applications may
  194.    now be configured with a seperate prefs program.
  195.  o removed support for environment variable "cybergraphics/pcdt_dither"
  196.    Please use the supplied prefs program PCDT to change dither settings now
  197.  o the expiration time is now 4 month instead of 1 month. So users who
  198.    can not access the net but get the datatype from an aminet cd are able
  199.    to use the picture.datatype release  for a certain amount of time
  200.    until a new version is released on cd
  201.  o there is an installer script now for v43 datatype installation which
  202.    also includes a backup option
  203.  o Tower JPEG Codec Class included as seperate archive
  204.  o new gif.datatype sub class V43.12 included
  205.  
  206. V43.718
  207.  
  208.  o bug fix in conjunction with datatype objects which require
  209.    mask planes and use planar bitmaps
  210.  o API-Demo source for datatype to ppm conversion added
  211.  o new versions of sub datatypes included
  212.  
  213. V43.716
  214.  
  215.  o ENV: "cybergraphics/pcdt_dither"
  216.    0 == Floyd Dithering(Better,slower) (DEFAULT)
  217.    1 == Ordered Dithering(Faster,Not so good gfx quality)
  218.  
  219. V43.713
  220.  
  221.  o new cybergraphics.library prerelease included
  222.  o the picture.datatype now uses ordered dithering as default.
  223.    A switch to select between floyd or ordered may follow in the
  224.    future
  225.  o included a new cyberncg.library which fixes a problem with
  226.    transparent images
  227.  o added V43 compatible PCX sub datatype to archive
  228.  
  229. V43.695
  230.  
  231.  o now supports AGA/ECS machines with cyberncg.library included in this archive.
  232.  
  233. V43.684
  234.  
  235.  o some internal structures have changed. Please use the new
  236.    cybergraphics.library coming with this archive
  237.  o the picture.datatype expires after a few weeks now
  238.    (all pre release versions will do that in the future)
  239.  o fixed a problem in conjunction with PDTA_DestBitMap and
  240.    ODF_USEFRIENDBITMAP which caused twice freed BitMaps in
  241.    the past
  242.  
  243. V43.667
  244.  o Fixed a 24bit->8Bit(OldBitmap) Dither problem.
  245.    Was caused by a change of the CyberBitmap checking code.
  246.    This may be the problem some experienced with PPaint which
  247.    i don't have to test it out...
  248.  
  249. V43.658
  250.  o Fixed a MUI Pattern problem
  251.  o Added DTM_DRAW...not tested
  252.  
  253. V43.647
  254.  o Fixed the remap problem some people experienced
  255.  
  256. V43.629
  257.  o Finally fixed the mysterious crash bug.
  258.  
  259. V43.6xx
  260.  o Multiview cludge
  261.  o Smarter Monitor ID overruling
  262.  o Alphachannel support
  263.  o fixed PDTA_DestMode,MODE_V42 fallback..
  264.  o Added an internal V43 compatibility list with the current entries:
  265.     "« IPrefs »",
  266.     "multiview",
  267.     "amigaguide",
  268.     "amosaic",
  269.     "amosaic-as225",
  270.     "amosaic-amitcp",
  271.     "DirectoryOpus",
  272.         NULL
  273.  o Fixed Aspect=0 save problem
  274.  o smarter PDTA_UseFriendBitMap that only does something when needed
  275.  o Truecolour alphachannel mask generation activated...will be used
  276.    automaticly by OM_RENDER
  277.  o 8Bit transparent mask generation activated...will be used automaticly
  278.    by OM_RENDER
  279.  o Fixed V42 fallback mode mungwall problems with dithering..hopefully.
  280.  o OM_Render transparent special handling..see docs for more infos
  281.  o Subdatatype Error API improvement
  282.  o creating transparent mask without layout if needed
  283.  o Fixed long outstanding V42 fallback color problem bug visible with DirOpus and others.
  284.  
  285. V43.451
  286.  o Important!!!!!
  287.    Include Change
  288.    DTM_BLITPIXELARRAY -> DTM_WRITEPIXELARRAY
  289.  
  290.  o PDTA_DEST works now. This means if PDTA_DEST,MODE_V43 isn't set
  291.    by application programs, a slow old planar bitmap is returned to
  292.    not break old programs that can only handle that bitmap.
  293.    Sigh..i could add an application list that works bitmaps format
  294.    independent.
  295.    Only exception is IPrefs for now...it gets a chunky bitmap.
  296.  
  297.  o PDTA_UseFriendBitMap is implemented(Stuntzi)
  298.  
  299.  o PDTA_NumPixMapDir
  300.    DTM_CREATEPIXMAPDIR
  301.    DTM_FIRSTPIXMAPDIR
  302.    DTM_NEXTPIXMAPDIR
  303.    DTM_PREVPIXMAPDIR
  304.    DTM_BESTPIXMAPDIR
  305.  
  306.    added to support multi-volume gfx formats like TIFF.
  307.  
  308.  o DTM_READPIXELARRAY added to avoid the sub datatype data sharing
  309.    design problem of the picture.datatype. If you ask me i would
  310.    have disallowed any data sharing at all because it destroys the
  311.    meaning of OO.
  312.  
  313.  o GAUGE disabled...there should be GAUGE Method imho
  314.  
  315. V43.395
  316.  
  317.  o Added a cludge to avoid a BestModeID crash
  318.  o Added a Volume Gauge...will be configurable in the future
  319.  o ilbm.datatype that handles 24bit...thanx Matthias
  320.  
  321. V43.352
  322.  
  323.  o Fixed a problem with WBPattern(not only this) and some pictures.
  324.    The reason was that BestCModeIDTagList() doesn't always work
  325.    and i had no fallback mode so the returned monitorid was INVALID.
  326.    This caused a lot problems..expecially the HAM/HALFBRIGHT bit test
  327.    on the modeid resulted into a wrong decision because INVALID=-1.
  328.  
  329. V43.340
  330.  
  331.  o DTM_PRINT added. It does nothing for 24Bit bitmaps.
  332.  
  333. V43.338
  334.  
  335.  o DTM_COPY added. It writes 8Bit and 24Bit output.
  336.  
  337. V43.335
  338.  
  339.  o DTM_WRITE added. It writes 8Bit and 24Bit output.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347. Questions&Bugreports
  348. Don't expect fast response.
  349.  
  350. Ralfph Schmidt
  351. laire@popmail.owl.de
  352.  
  353.  
  354.